| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
In diesem Kapitel finden vermutlich nur Programmierer Interessantes.
| 1.1 Was ist die beste Dokumentation f�r Programmierer? | ||
| 1.2 Was ist CATS? | ||
| 1.3 Wo bekomme ich die Amiga-Include-Dateien? | ||
| 1.4 Wie werde ich Developer? | ||
| 1.5 Was f�r Compiler (und Assembler) gibt es? | Was f�r Compiler (Assembler) gibt es? | |
| 1.6 Warum funktioniert keine Esc-Sequenz? | ||
| 1.7 Kann ich AmigaBasic auf dem A1200 verwenden? | ||
| 1.8 Wie lokalisiere ich mein Programm? | ||
| 1.9 Wie erh�lt man einen Zeiger auf das Fenster einer Konsole? | ||
| 1.10 Was sind Pragmas? | ||
| 1.11 Mein Compiler/Linker vermi�t Symbole. | ||
| 1.12 Wie erfahre ich, was f�r Funktionen es gibt? | ||
| • Der GNU C Compiler | Der GNU C Compiler: Allgemeine Information und Installation |
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Die beste verf�gbare Dokumentation sind sicherlich die RKM’s (ROM Kernel Manuals, die schwarzen) von Commodore. Sie werden von Addison-Wesley ver�ffentlicht.
The Amiga ROM Kernel Manual: Libraries, ISBN 0-201-56774-1
The Amiga ROM Kernel Manual: Devices, ISBN 0-201-56775-X
The Amiga ROM Kernel Manual: Includes and Autodocs, ISBN
0-201-56773-3
The Amiga Hardware Manual, ISBN 0-201-56776-8
The Amiga User Interface Style Guide, ISBN 0-201-57757-7
Vor allem die Libraries sind ein Mu�. Weniger n�tzlich sind die Includes und Autodocs: Sie sind auf Diskette als Online-Hilfe sicher n�tzlicher. See section Wo bekomme ich die Amiga-Include-Dateien?.
AmigaDOS wird in diesen B�chern kaum behandelt. Die Autodocs geben einige Informationen, aber um tiefer einzusteigen braucht man das
The AmigaDOS Manual, 3rd Edition, ISBN 0-553-35403-5
ebenfalls von Commodore, das von Bantam Books herausgegeben wird.
Eine gute Wahl ist auch
The Amiga Guru Book
von Ralph Babel. Das Buch beginnt mit einem ca. 250-seitigen allgemeinen �berblick �ber verschiedenste Aspekte der Programmierung des Amiga. F�r Anf�nger d�rften vor allem die Abschnitte �ber die Amiga-Datentypen sowie die Amiga-Includes und die amiga.lib interessant sein, aber auch Erfahrene finden hier mit Sicherheit noch Neues, was zum Teil nicht einmal in den RKM’s enthalten ist. Den gr��ten Teil des Buches nehmen aber 500 Seiten nur zu AmigaDOS ein. Dieser Teil ist meines Erachtens der wichtigste, weil das AmigaDOS-Manual der schlechteste Teil der offiziellen Dokumentation ist. Das Buch ist sehr dicht geschrieben und deshalb weniger leicht lesbar als die RKM’s, aber ich empfehle es als Zusatz und vor allem anstelle des AmigaDOS-Manuals. (Allerdings ist das Guru-Buch kein Ersatz f�r die Libraries & Devices, die hier nicht behandelt werden.) Ungl�cklicherweise hat das Buch keine ISBN-Nummer und ist deshalb nur bei den folgenden Adressen erh�ltlich:
Almathera Systems Limited
Southerton House
NBG USA, Inc. Boundary Business Court
482 Holly Avenue 92-94 Church Road
St. Paul, MN 55102 Mitcham, Surrey CR4 3TD
USA England
Voice: +1 (612) 290 9447 Voice: +44 181 687 0040
Fax: +1 (612) 290 9449 Fax: +44 181 687 0490
E-Mail: <almathera@cix.compulink.co.uk>
Stefan Ossowskis Schatztruhe
Hirsch & Wolf OHG Gesellschaft f�r Software mbH
Mittelstra�e 33 Veronikastra�e 33
D-56564 Neuwied D-45131 Essen
Germany Germany
Voice: +49 (2631) 8399-0 Voice: +49 (201) 788778
Fax: +49 (2631) 8399-31 Fax: +49 (201) 798447
E-Mail: <stefano@tchest.e.eunet.de>
Someware
27 rue Gabriel P�ri
59186 Anor
France
Voice: +33 27596000
Fax: +33 27595206
E-Mail: <didierj@swad.someware.com>
F�r weitere Informationen empfehle ich auch die FAQ von Marc Atkins �ber
B�cher zum Thema Amiga, die alle 4 Wochen in comp.sys.amiga.misc
erscheint.
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Dies ist eine Abteilung von Commodore West Chester, die fr�her
Commodore Amiga Technical Support hie� und sp�ter in
Commodore Application and Technical Support umbenannt wurde. Die
Mitglieder arbeiten unabh�ngig
von der Entwicklungsabteilung, aber eng mit ihr zusammen, und versuchen,
Entwicklern au�erhalb von Commodore beim Erstellen guter Amiga-Anwendungen
zu helfen, sei das eine Hard- oder Software. Dazu hat CATS eine Menge
an Informationen und Tools gesammelt, auf Floppy, CD oder Papier. Ein
gro�er Teil dieses Materials ist auch der Allgemeinheit, d. h. f�r
Nicht-Developer zug�nglich. Aber bitte CATS nicht mit einer Hotline
verwechseln!
Amerikaner k�nnen das Material von
CATS
Commodore Electronics Limited
950 Rittenhouse Road
Norristown, PA 19403
bekommen, der Distributor f�r ganz Europa ist die
Fa. Hirsch & Wolf
Mittelstr. 33
56564 Neuwied
Tel. 02631/83990
Dr. Peter Kittel, peterk@cbmger.de.so.commodore.com
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Der einzige legale Weg, die Include-Dateien und die AutoDocs zu bekommen
(und Sie sollten sie bekommen, sie sind sehr n�tzlich!), ist,
Developer zu werden (siehe see section Wie werde ich Developer?) oder das sogenannte NDU
(Native developers update kit, auch als NDUK, NDK bekannt oder
ADU f�r Amiga Developer Update)
bei CATS zu kaufen. See section Was ist CATS?. Es kostet etwa 50DM, was sicher ein
fairer Preis ist. Dabei handelt es sich um ein 5-Disketten-Set, das neben
den aktuellen Includes und AutoDocs auch Tools f�r Programmierer,
z.B. Enforcer, Mungwall, Sushi und die debug.libg (zum Debuggen) sowie
anderes, z.B. CatComp (see section Wie lokalisiere ich mein Programm?) oder Report (f�r
Bug-Reports oder Vorschl�ge an Commodore) enth�lt. Die aktuelle
Version ist 3.1 und f�r Programmierer beinahe obligatorisch.
Wem die Includes gen�gen, der kann diese �ber ein Update seines Compilers (nur kommerzielle Compiler) oder von den Fish-CDs bekommen. @xref{Fish-CD}.
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Um Developer zu werden, braucht man die ADSP-Antragsformulare (Amiga
developer support program). Um diese zu bekommen, sollte man einen Brief
an die lokale Commodore-Niederlassung schreiben und nach diesen Papieren
fragen, in denen das weitere erkl�rt wird. In Deutschland ist die
Adresse folgende:
Commodore
Lyoner Stra�e 38
60528 Frankfurt
Es gibt drei verschiedene Arten von Developern:
Hier bekommt man vor allem Zugang zum CBMNET (eine Art Commodore-internes Usenet), �ber das man direkt mit anderen Entwicklern auch von Commodore selber �ber seine Probleme diskutieren kann. Die Jahresgeb�hr betr�gt 150 DM, die einmalige Aufnahmegeb�hr 50 DM.
Dies ist die interessanteste Klasse: Man bekommt von der meisten Systemsoftware die aktuellen Beta-Versionen (z. B. Kickstart und Workbench) sowie die dazugeh�rigen Includes und AutoDocs. Certifieds bekommen aber nicht jede Beta und in der Regel auch keine Hardware-Beta. Man bezahlt 400 DM pro Jahr daf�r und eine einmalige Aufnahmegeb�hr von 100 DM.
Kommerzielle Entwickler bekommen im wesentlichen dieselben Informationen wie die "Zertifizierten", allerdings kompletter, sprich auch Beta-Hardware, und etwas fr�her. Dies hat auch seinen Preis: 700DM pro Jahr plus einmalige Aufnahmegeb�hr von 100DM.
Die Preise und die angebotenen M�glichkeiten k�nnen von Land zu Land verschieden sein, auch gibt es meines Wissens nicht in allen L�ndern den "Registered". Ein guter Tip ist es, eine Gruppe zu bilden und damit die Kosten zu reduzieren.
Alle Entwickler m�ssen Non-disclosure agreements (NDA) unterzeichnen.
Diese besagen, da� sie �ber die erhaltenen Informationen au�erhalb von
speziell dazu freigegebenen Orten oder Kan�len nicht einmal zu anderen
Entwicklern sprechen d�rfen, so lange sie nicht die explizite Erlaubnis
dazu von Commodore haben.
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Es gibt viele Programmiersprachen auf dem Amiga, kommerzielle Compiler ebenso wie frei kopierbare. Ich m�chte nur diejenigen aufz�hlen, die mir bekannt sind oder die ich aus einem anderem Grund f�r erw�hnenswert halte.
Alle C-Compiler beinhalten einen Assembler. Frei kopierbar und zuverl�ssig sind A68K und PhxAss. (Aminet, Directory ‘dev/asm’ oder Fish-Disks 521 bzw. 906)
Kommerzielle Assembler sind MaxonASM, OMA3.0 und DevPack3.14.
Derzeit sind folgende kommerzielle Basic-Compiler/Interpreter verf�gbar: BlitzBasic2, Amos und MaxonBasic3.
Frei kopierbare C-Compiler sind der gcc (der sein eigenes Directory
‘dev/gcc’ auf dem Aminet hat) und die Probeversion (mit der man aber
schon eine ganze Menge anfangen kann) von Dice (per FTP von
ftp.uni-paderborn.de, Directory
‘/news/comp.binaries.amiga/volume91/languages’ oder auf Fish disk 491).
Der gro�e Vorteil von gcc ist, da� man ihn auf der ganzen Welt
und auf nahezu jedem Computer findet. Ein weiterer Vorteil ist, da� er sogar
einen C++-Compiler enth�lt! Aber er ist langsam und ben�tigt 4MB RAM oder
mehr. @xref{Der GNU C Compiler}. @xref{Mail-Listen}.
Kommerzielle C-Compiler sind Aztec-C, Dice, SAS-C
und MaxonC++.
Aztec-C wird jedoch leider nicht mehr weiterentwickelt.
Was die kommerziellen Compiler auszeichnet, sind ihre hervorragenden
Source-Level-Debugger, die den anderen fehlen.
SAS hat leider angek�ndigt, den Amiga-Compiler nicht weiter zu unterst�tzen. Verkauft wird er aber noch, und da er gegenw�rtig noch voll aktuell ist und sogar einen Crosscompiler von C++ in C enth�lt (der vom Debugger unterst�tzt wird), ist er meines Erachtens derzeit das beste Angebot, insbesondere zu dem �u�erst g�nstigen Preis von 184.-DM f�r Studenten und Besitzer anderer Compiler. In Deutschland erh�lt man SAS/C bei
SAS Institute, Inc. SAS Institute GmbH
Book Sales Postfach 10 53 40
SAS Campus Drive 69043 Heidelberg
Cary, NC 27513 Deutschland
USA
Phone: (919)677-8000 Telefon: 06221/4160
EMail: sasdsb@vm.sas.com EMail: eurdoc2@vm.sas.com
Dice bietet wie SAS einen Sonderpreis f�r Sch�ler und Studenten von ca. 130.-DM. Der Compiler ist stabil und vor allem sehr schnell. Der gr��te Nachteil von Dice ist (verglichen mit den anderen kommerziellen Compilern) der Debugger, ein sogenannter Source-Line-Debugger: Dies bedeutet, da� man den Quelltext sieht und das Programm Schritt f�r Schritt abarbeiten kann, aber leider nur Speicher und nicht etwa bestimmte Variablen anzeigen kann. Informationen �ber Dice: info@oic.COM.
Comeau C++ ist ebenfalls ein Crosscompiler, was an und f�r sich kein
Problem w�re. Aber Comeau C++ hat keinen integrierten C-Compiler,
man braucht also zus�tzlich SAS-C, Aztec-C oder Dice. Daf�r ist er
kompatibel zu AT&T cfront 3.0, unterst�tzt Exceptions und l�uft wie
gcc auf vielen verschiedenen Systemen. In Deutschland wird auch
Maxxon C++ angeboten, �ber das ich nichts sagen kann. Beide Compiler
sind kommerziell. Comeau’s Adresse ist:
Comeau computing
91-34, 120th Street
Richmond Hill, NY, 11418-3214
USA
EMail: Greg Comeau, comeau@bix.com
MaxonC++ ist sowohl ein C++ als auch ein C Compiler. Es gibt eine Light-Version f�r ca. 190 DM und eine Developer-Version f�r ca. 450 DM. Die Developer-Version entspricht dem AT&T-Standard 3.0. Maxon-Light enth�lt einen Compiler und einen Editor. Developer umfa�t einen Source-Level-Debugger, eine Amiga-Klassenbibliothek und Hot Help mit Dokumenten zu den Amiga-Libs. Da es ein deutsches Produkt ist, sind Compiler und Dokumentation in Deutsch gehalten. Der Compiler besitzt einige kleinere Fehler, trotzdem kann man mit ihm gut arbeiten.
JForth soll eine exzellente Forth-Version sein. Unter anderem enth�lt es objektorientierte Erweiterungen, ein volles Amiga-Interface und einen Anwendungsgenerator. Es ist erh�ltlich von:
Delta Research
P.O. Box 151051
San Rafael, CA 94915-1051
Phone: (415) 453-4320
EMail: Phil Burk, phil@ntg.com
Mike Haas, haas@starnine.com
(Seufz! Es gibt immer noch Leute, die es brauchen :-<) Frei kopierbar sind BCF (Fish disk 470) und f2c, der Fortran in C-Quelltext umwandelt. (Aminet, Directory ‘/dev/lang’). Ein kommerzieller Compiler ist von ABSoft erh�ltlich. Allerdings sind dies alles nur Fortran-77-Compiler, es gibt keine Fortran-90-Compiler auf dem Amiga.
Frei kopierbare Lisp-Interpreter sind XLisp (Fish-Disk 181) und OakLisp
(Fish-Disks 519 und 520) und CLISP (‘/pub/lisp/clisp/binaries/amiga’ at
‘ma2s2.mathematik.uni-karlsruhe.de’). Auch Compiler gibt es: Gambit
(Fish-Disks 764 und 765) sowie Scheme-to-C (Fish-Disks 556-558). Von
Interesse ist vielleicht eine Mail-Liste: Senden Sie dazu eine Mail mit dem
Wort ‘Subscribe’ an amigalisp@contessa.phone.net.
‘/dev/lang/UNSWProlog.lha’ und ‘dev/lang/sbp3_1e’ auf dem Aminet sowie ‘SBProlog’ auf der Fish-Disk 141 und ‘SBProlog’ auf der Fish-Disk 145 sind frei kopierbare Prolog-Interpreter.
M2Amiga wird in Europa und Benchmark Modula-2 in den USA angeboten. Beide sollen sehr gut sein und sowohl �ber gute Source-Level-Debugger als auch eine umfangreiche Bibliothek verf�gen. Besonders M2Amiga wird sehr gut unterst�tzt durch eine deutsche Benutzergruppe (AMOK), die z.B. eine eigene PD-Serie anbieten. @xref{Mail-Listen}.
M2Amiga bekommt man bei
A+L AG
Daderiz 61
2540 Grenchen
Schweiz
Tel.: +41/65/52 03-11
Fax: -79
und Benchmark Modula-2 ist erh�ltlich von:
Armadillo Computing
5225 Marymount Drive
Austin, Texas 78723
USA
Phone/FAX: 512/926-0360.
EMail: Jim Olinger, jolinger@bix.com
Es gibt zwei Oberon-2-Compiler f�r den Amiga: AmigaOberon ist wie M2Amiga von A+L und kommerziell. Der Compiler kommt mit einer integrierten Entwicklungsumgebung (incl. freikonfigurierbarem Editor) und umfangreicher Modulbibliothek. Library Linker zum einfachen Erzeugen von AmigaOS Shared Libraries sowie Run-time Source-Level-Debugger sind ebenfalls erh�ltlich.
Oberon-A ist ein Freeware-Compiler, allerdings erst in einer Beta-Version, insbesondere sind die Modulbibliotheken unvollst�ndig. (Quelle: Aminet, Directory ‘dev/obero’). @xref{Mail-Listen}.
F�r beide Compiler gibt es Unmengen von Modulen und Bsp.-Sourcen auf AMOK-Disks.
Zus�tzlich zu den beiden Standalone-Compilern, die vor allem zum Entwickeln von AmigaOS-Applikationen geeignet sind, existiert noch eine Portierung des Oberon System V4, das ebenfalls einen Oberon-2 Compiler beinhaltet. Das Oberon System l�uft auf dem Amiga als ein AmigaOS-Task auf einem eigenen Screen. Hiermit kann man Software entwickeln, die auch auf allen anderen Implementierungen des Oberon System V4 (z.B. f�r Macintosh, Windows oder Sparc) nahezu ohne jede �nderung lauff�hig ist.
Es gibt einen PD-Compiler namens PCQ (Aminet, Directory ‘dev/lang’ oder Fish-Disk 511), der allerdings kein voller Pascal-Compiler ist und dem sehr wesentliche Dinge fehlen. P2C konvertiert Pascal in C und ist auf der Fish-Disk 341 zu finden. (Aminet: ‘/dev/misc/p2c120.lha’) Ferner gibt es zwei kommerzielle Compiler namens HiSoft-Pascal (von der gleichnamigen Firma) und KickPascal von Maxxon. HiSoft und P2c behaupten, kompatibel zu Turbo-Pascal 5.0 zu sein. HiSoft hat au�erdem einen guten Source-Level-Debugger.
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Viele Drucker kommen mit einem Handbuch, das erkl�rt, welche
<Esc>-Sequenzen welche Funktion ausl�sen. Aber wenn man diese Sequenzen
dann einmal ausprobiert, passieren oft merkw�rdige Sachen, n�mlich entweder
gar nichts oder etwas ganz anderes, als geplant war. Und das hat auch
einen Grund, n�mlich die Amiga-Druckertreiber. Diese Treiber sind so
gebaut, da� sie nur einen bestimmten Satz ANSI-Esc-Sequenzen
verstehen, nicht die (verschiedenen) druckereigenen, von den verschiedenen
Druckerherstellern definierten. Der Sinn dabei ist, da� jede Anwendung
auf dem Amiga nur diesen einen Standardsatz an Sequenzen verwendet und
so nicht zu wissen braucht, welcher Drucker tats�chlich angeschlo�en
ist. Der Druckertreiber �bersetzt dann diese Standardsequenzen in die
druckereigenen. Eine Liste der verf�gbaren ANSI-Esc-Sequenzen findet
sich im aktuellen Workbench-Handbuch (oder in �lteren
AmigaDOS-Handb�chern). Wenn Du nun eine Steuersequenz an den Drucker schicken
willst, die es nicht als ANSI-Sequenz gibt, so hast Du zwei M�glichkeiten,
dies doch zu erreichen:
‘Esc[<n>"<x>’
wobei ‘<n>’ die dezimal geschriebene Anzahl an Bytes in der Sequenz ‘<x>’ ist, die gerade die spezielle Drucker-Sequenz enth�lt. Diese ANSI-Sequenz sagt dem Druckertreiber, da� er die n�chsten ‘<n>’ Bytes nicht interpretieren oder �bersetzen soll.
Aber beide Methoden haben einen grossen Nachteil, wenn sie in einem Anwendungsprogramm verwendet werden: Man verliert die Druckerunabh�ngigkeit! Solange man sich an die ANSI-Sequenzen h�lt, kann man jeden Drucker der Welt ansteuern, solange es einen Amiga-Druckertreiber f�r ihn gibt. Wenn man anf�ngt, druckereigene Sequenzen zu verwenden, ist das Programm an diesen einen Druckertyp gebunden und mit keinem anderen benutzbar (oder man m��te einige dutzend neue Druckertreiber f�r dieses Programm erstellen).
Dr. Peter Kittel, peterk@cbmger.de.so.commodore.com
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Letztens ging eine Kontroverse �ber AmigaBasic durch die Netze: Ich sagte, auf dem A1200 l�uft es einigerma�en problemlos, jemand anders berichtete, da� es bei jedem kleinsten Fehler sofort komplett abst�rzt, was ich nicht nachvollziehen konnte.
Jetzt kann ich es: Es liegt am Sound-Prefs-Editor. Wenn man in ihm die Sound-Ausgabe ganz abschaltet, kann man mit AmigaBasic arbeiten. Wenn hier ein Sound (z. B. Piepsen) angew�hlt ist, kollidiert das mit dem Sound, den AmigaBasic offensichtlich zu Fu� und nicht ganz korrekt selber erzeugen will, bumm.
Abhilfe also:
Dr. Peter Kittel, peterk@cbmger.de.so.commodore.co
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Nehmen wir an, wir wollen ein HelloLocalWorld.c schreiben. Das
letztendliche Programm sieht dann ungef�hr so aus:
#include "HelloLocalWorld_Cat.h"
#include <clib/exec_protos.h>
struct Library *LocaleBase;
void main(int argc, char *argv[])
{
/* �ffne die locale.library. (Kein Abbruch, wenn sie nicht
da ist, weil dann einfach die eingebauten Strings verwendet
werden. Aus diesem Grund auch keine Verwendung des
AutoOpening, auch wenn es der Compiler beherrscht.)
*/
LocaleBase = OpenLibrary("locale.library", 38);
OpenHelloLocalWorldCatalogs(NULL, NULL);
printf(GetString(MSG_Hello));
CloseHelloLocalWorldCatalog();
if (LocaleBase) CloseLibrary(LocaleBase);
}
Die Funktion GetString pr�ft, ob die gew�nschten Kataloge vorhanden sind und liefert einen Zeiger auf einen String, entweder den eingebauten oder den Katalogstring. (In unserem Fall den deutschen String.)
Der Hauptunterschied zum gewohnten HelloWorld.c ist also (abgesehen von der minimalen Initialisierung und dem Gegenst�ck am Programmende, das bei den meisten modernen Programmiersprachen oder unter C mit Hilfe des FlexCat-Paketes sogar auch noch entf�llt), Strings durch einen Funktionsaufruf zu ersetzen. Man braucht also eine Datei ‘HelloLocalWorld_Cat.c’, die die Funktionen OpenHelloLocalWorld, GetString, CloseHelloLocalWorld_Cat.h und die eingebauten Strings enth�lt (dies k�nnte ein Array sein, das unter anderem
array[MSG_Hello] = "Hello, local world.\n";
enth�lt) und ein Includefile ‘HelloLocalWorld_Cat.h’, das die
ID’s wie MSG_Hello definiert. Es ist nicht n�tig zu wissen, wie diese
Dateien intern arbeiten, insbesondere ben�tigt man auch keine Kenntnis
der locale.library!
Dazu gibt es verschiedene Kataloggeneratoren (im Folgenden KG), n�mlich
‘CatComp’ (nur f�r Developer), KitCat (nur deutsche
Dokumentation, was hierzulande kein Problem ist), ‘MakeCat’ (das ich
nicht kenne) und FlexCat (das ich empfehle, einerseits, weil
es sehr flexibel im erzeugten Source ist und z.B. Lokalisierung unter 2.0
sowie beliebige Programmiersprachen unterst�tzt, selbst Amiga-E, Cluster,
Pascal, ... und andererseits, weil es von mir ist ;-) ), die diese Dateien
sowie die Kataloge erzeugen. (Der obige Quelltext k�nnte je nach KG
leicht unterschiedlich aussehen.) Siehe Aminet, directory ‘dev/misc’.
Wie funktionieren diese KGs? Zun�chst erzeugt man eine sogenannte
Katalogbeschreibung (Catalog description), die so aussehen
k�nnte:
; Mit einem Semikolon beginnende Zeilen sind Kommentare
# language english
; die Sprache der eingebauten Strings
# version 0
; die Katalogversion (0 = beliebig)
MSG_Hello (1/15/30)
Hello, local world
Jeder String wird durch zwei Zeilen wie die letzten beiden definiert: MSG_Hello ist die String-ID, (1/15/30) gibt den Wert der ID sowie die minimale und maximale L�nge an. (Diese Argumente k�nnen auch weggelassen werden, in welchem Fall einfach die n�chste freie ID verwendet wird.)
Nun schreiben wir das Programm. Sobald es fertig ist, wird mit dem KG eine sogenannte Katalog�bersetzung (eine f�r jede andere Sprache als die eingebaute) erzeugt, die so aussehen k�nnte:
; Mit einem Semikolon beginnende Zeilen sind Kommentare
## language deutsch
; the catalog language
## version $VER: Deutsch.catalog 1.0 (22.12.93)
; the catalog files version string
MSG_Hello
; Hello, local world
Beachten Sie die leere Zeile nach der String-ID! (Die Argumente von
## language und ## version w�ren vielleicht leer.) Hier m�ssten
jetzt die deutschen Strings eingesetzt werden. Mit dem KG wird daraus
dann der eigentliche Katalog erzeugt. (Beachten Sie auch, da�
hier die Angaben �ber String-ID und Stringl�nge fehlen: Sie werden
aus der Katalogbeschreibung �bernommen.
Wenn das Programm ver�ndert wird (neue Strings, andere L�ngen) und die Katalogbeschreibung sich damit ebenfalls �ndert, dann kann der KG analog benutzt werden, um auch die Katalog�bersetzung und damit den Katalog auf den neuesten Stand zu bringen.
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Die folgende Funktion liefert den Window-Zeiger eines CON-Fensters. Sie kann unter allen Versionen des Amiga-OS ausgef�hrt werden.
struct Window *getConWindowPtr(BPTR fh)
{
struct Window *w;
struct FileHandle *cfh;
struct StandardPacket *sp;
struct InfoData *id;
struct MsgPort *mp;
w = NULL;
if ((cfh = BADDR(fh))->fh_Type != NULL) {
if (sp = AllocMem(sizeof (struct StandardPacket),
MEMF_PUBLIC | MEMF_CLEAR)) {
if (id = AllocMem(sizeof (struct InfoData),
MEMF_PUBLIC | MEMF_CLEAR)) {
if (mp = CreatePort(NULL, 0)) {
sp->sp_Msg.mn_Node.ln_Name = (char *) &sp->sp_Pkt;
sp->sp_Pkt.dp_Link = &sp->sp_Msg;
sp->sp_Pkt.dp_Port = mp;
sp->sp_Pkt.dp_Type = ACTION_DISK_INFO;
sp->sp_Pkt.dp_Arg1 = MKBADDR(id);
PutMsg(cfh->fh_Type, &sp->sp_Msg);
(void) WaitPort(mp);
(void) GetMsg(mp);
if (sp->sp_Pkt.dp_Res1)
w = (struct Window *) id->id_VolumeNode;
DeletePort(mp);
}
FreeMem(id, sizeof (struct InfoData));
}
FreeMem(sp, sizeof (struct StandardPacket));
}
}
return w;
}
Anmerkungen:
Weitere Informationen finden Sie auf den Seiten 273, 276, 435, 463, 485 und 629 im "Amiga Guru Book" (see section Was ist die beste Dokumentation f�r Programmierer?).
Ralph Babel, rbabel@babylon.pfm-mainz.de
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Pragmas sind spezielle Anweisungen an den C-Compiler. Zwei Probleme entstehen bei der Verwendung von Pragmas:
#ifndef MY_COMPILER
#pragma DoAnything
#endif
Das letztere Problem l��t sich umgehen, indem man Pragmas wie folgt in eigene Include-Files setzt. (Das gleiche gilt �brigens auch f�r Pr�prozessor-Kommandos wie #asm (Aztec-C) oder #extern (C++).)
#ifndef MY_COMPILER
#include <mypragmas.h>
#endif
Aber was machen Pragmas auf dem Amiga? Meistens werden sie verwendet,
um dem Compiler mitzuteilen, wie gewisse Library-Funktionen aufgerufen
werden. (Tats�chlich wird fast immer diese Verwendung gemeint, wenn
Amiga-Besitzer �ber Pragmas sprechen.) Gew�hnliche C-Funktionen erwarten
ihre Argumente auf dem Stack, Library-Funktionen dagegen in bestimmten
Registern. Ferner erwarten sie den Library-Base-Pointer in Register a6.
Betrachten wir eine Pragma-Anweisung von Aztec-C:
#pragma amicall(SysBase,0xd2,FreeMem(a1,d0))
Dies weist den Compiler an, das erste Argument in Register a1 und das zweite in d0 zu laden. Ferner wird der Inhalt der Variablen SysBase in Register a6 geladen. Maxon-Pragmas sehen genauso aus, Dice- und SAS-Pragmas sind allerdings etwas komplizierter:
#pragma libcall SysBase FreeMem d2 0902
Hier ist d2 (wie 0xd2 oben) der Library-Vektor-Offset (siehe
n�chstes Beispiel). Die letzte Ziffer ist die Zahl der Argumente, die
davorstehende 0 ein Code f�r das Register mit dem Ergebnis und die davor
stehenden Ziffern sind Codes f�r die Register mit den Argumenten in
verkehrter Reihenfolge. (Die Codes bedeuten 0=d0, 1=d1, .., 8=a0, 9=a1, a=a2,
..)
Ein Kommando wie ‘FreeMem(fib,sizeof(*fib);’ w�rde ein Compiler nun in folgenden Code �bersetzen:
move.l _fib,a1
move.l 260,d1 ; sizeof(struct FileInfoBlock)
move.l _SysBase,a6
jsr -0xd2(a6) ; 0xd2 = _LVOFreeMem
FreeMem in dieser Art aufzurufen ist k�rzer und schneller als zun�chst die Argumente auf den Stack zu legen und dann eine Funktion _FreeMem aufzurufen, die letzten Endes doch nur dasselbe tun und die Argumente vom Stack in dieselben Register laden w�rde.
Das Portierungsproblem der Pragmas umgeht man, indem man sie folgenderma�en in den eigenen Quelltext einbindet:
/* SAS/C, Dice und GNU-c (ab Version 2.6.1) machen es */
/* ganz einfach: */
#if defined(__SASC) || defined(_DCC) || defined(__GNUC__)
#include <proto/exec.h>
#else
/* Lade den Funktionsprototyp. Dieser ist nicht vom */
/* verwendeten Compiler abh�ngig. */
#include <clib/exec_protos.h>
/* Pragmas sind vom Compiler abh�ngig, aber wenigstens */
/* die Namen der Dateien mit Pragmas sind relativ */
/* einheitlich. */
#ifdef AZTEC_C
#include <pragmas/exec_lib.h>
#elif defined(__MAXON__)
#include <pragmas/exec_pragmas.h>
#endif
/* Deklariere SysBase-Variable */
extern struct ExecBase *SysBase;
#endif
Das obige Beispiel kann problemlos mit allen angegebenen Compilern verwendet werden und produziert optimalen Code. (Die proto/*.h-Files machen �brigens auch nichts anderes als clib/*_protos.h und pragmas/*_pragmas.h mit #include einzulesen und dann die SysBase-Variable zu deklarieren.)
Eine abschlie�ende Frage bleibt allerdings: Wie bekommt man die Pragmas?
Die meisten Compiler haben bereits fertige Pragmas im Lieferumfang.
Allerdings hilft das nicht, wenn man z.B. eine neue Library benutzen
m�chte oder nur die Pragmas einer veralteten Version hat. In diesem Fall
kann man die Pragmas selbst aus den sogenannten FD-Files erzeugen.
Dazu haben die meisten Compiler ein Utility namens fd2pragma.
(Das NDU hat z.B. ein Directory namens FD, in dem die FD-Files aller
Libraries und Devices des OS enthalten sind. see section Wo bekomme ich die Amiga-Include-Dateien?) Es gibt
auch ein frei kopierbares fd2pragma, das Pragmas f�r Aztec, Dice, SAS und
Maxon sowie LVO-Files f�r den Aztec-Assembler und eventuelle Tag-Versionen
produziert. (Aminet, ‘dev/misc/fd2pragma2_0.lha’ oder auf den
Fish-CDs)
F�r Pragmas unter dem gcc siehe @ref{Inline-Dateien}.
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Zun�chst sollte man sich versichern, da� die Funktion tats�chlich fehlt:
Z.B. Floating-Point-Funktionen befinden sich in einer speziellen
Link-Library, die erst mit der Option ‘-lm’ eingebunden wird.
Ferner kann es eine fehlende Variable sein: Wenn man z.B. ohne es zu
bemerken eine Intuition-Funktion benutzt, dann wird der Linker �ber das
Fehlen eines Symbols IntuitionBase klagen. In diesem Fall mu�
man also lediglich das Folgende irgendwo im globalen Teil seines
Quelltextes einbauen:
struct Library *IntuitionBase;
(Und vergessen Sie nicht, die Library mit OpenLibrary() zu er�ffnen und mit CloseLibrary() zu schlie�en!) :-)
Allerdings k�nnte die Funktion nat�rlich tats�chlich fehlen. Wenn man zum Beispiel nur die Version 2.0 der amiga.lib hat, dann fehlen etwa die Locale-Funktionen oder die Memory-Pool-Funktionen, obwohl sie prinzipiell verwendbar sind. (2) Die einfachste (und beste) L�sung ist, das sogenannte NDU zu kaufen. See section Wo bekomme ich die Amiga-Include-Dateien?. Wer nicht solange warten m�chte, f�r den ist die Frage, welche Art von Funktion in seiner Link-Library fehlt:
#include <clib/dos_protos.h>
#include <pragmas/dos_pragmas.h> /* Evtl. anderer Name */
void *AllocDosObjectTags(ULONG objtype, Tag tag1, ...)
{ return(AllocDosObject(objtype, (struct TagItem *) &tag1);
}
Mit fd2pragma kann das auch automatisch geschehen. See section Was sind Pragmas?.
| [ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Wenn Sie sich �ber den Namen einer f�r einen bestimmten Zweck geeigneten Funktion im Unklaren sind, dann gibt es folgende M�glichkeiten:
Dr. Peter Kittel, peterk@cbmger.de.so.commodore.com
| [Top] | [Contents] | [Index] | [ ? ] |
Nur bei einem zus�tzlichen Prozessor
Dieses Problem betrifft vor allem Besitzer von Aztec-C, das seither nicht weiter unterst�tzt wird und von Dice, der manchmal etwas unvollst�ndig ist. Ich besitze beide ..
| [Top] | [Contents] | [Index] | [ ? ] |
This document was generated on August 24, 2022 using texi2html 5.0.
The buttons in the navigation panels have the following meaning:
| Button | Name | Go to | From 1.2.3 go to |
|---|---|---|---|
| [ << ] | FastBack | Beginning of this chapter or previous chapter | 1 |
| [ < ] | Back | Previous section in reading order | 1.2.2 |
| [ Up ] | Up | Up section | 1.2 |
| [ > ] | Forward | Next section in reading order | 1.2.4 |
| [ >> ] | FastForward | Next chapter | 2 |
| [Top] | Top | Cover (top) of document | |
| [Contents] | Contents | Table of contents | |
| [Index] | Index | Index | |
| [ ? ] | About | About (help) |
where the Example assumes that the current position is at Subsubsection One-Two-Three of a document of the following structure:
This document was generated on August 24, 2022 using texi2html 5.0.